home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 March / Macworld (1998-03) (Disk 1).dmg / Shareware World / Info / For Developers / GhostScript 5.10 / MacGS-510 / doc / ps2pdf.txt < prev    next >
Text File  |  1997-09-29  |  5KB  |  111 lines
  1.    Copyright (C) 1996, 1997 Aladdin Enterprises.  All rights reserved.
  2.   
  3.   This file is part of Aladdin Ghostscript.
  4.   
  5.   Aladdin Ghostscript is distributed with NO WARRANTY OF ANY KIND.  No author
  6.   or distributor accepts any responsibility for the consequences of using it,
  7.   or for whether it serves any particular purpose or works at all, unless he
  8.   or she says so in writing.  Refer to the Aladdin Ghostscript Free Public
  9.   License (the "License") for full details.
  10.   
  11.   Every copy of Aladdin Ghostscript must include a copy of the License,
  12.   normally in a plain ASCII text file named PUBLIC.  The License grants you
  13.   the right to copy, modify and redistribute Aladdin Ghostscript, but only
  14.   under certain conditions described in the License.  Among other things, the
  15.   License requires that the copyright notice and this notice be preserved on
  16.   all copies.
  17.  
  18. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  19.  
  20. This file, ps2pdf.txt, contains some information about Ghostscript's
  21. PostScript to PDF converter.
  22.  
  23. For an overview of Ghostscript and a list of the documentation files, see
  24. README.  
  25.  
  26. About ps2pdf
  27. ============
  28.  
  29. ps2pdf is a work-alike for a large subset of Adobe's Acrobat Distiller (TM)
  30. product: it converts PostScript files to PDF files.
  31.  
  32. ps2pdf is implemented as a very small shell script (batch file) that invokes
  33. Ghostscript selecting a special "output device" called pdfwrite.  In order
  34. to use ps2pdf, you must have included the pdfwrite device in the DEVICE_DEVS
  35. list at the time Ghostscript was built.  Currently, this device is included
  36. in the makefiles for all 32- and 64-bit platforms.
  37.  
  38. The usage for ps2pdf is:
  39.     ps2pdf input.ps output.pdf
  40. or, on Unix systems and some versions of Windows NT and OS/2 only,
  41.     ps2pdf input.ps
  42. which is equivalent to
  43.     ps2pdf input.ps input.pdf
  44.  
  45. The ps2pdf script assumes that the Ghostscript executable is named gs.  On
  46. MS-DOS and MS Windows, you will need to edit the script (ps2pdf.bat) if the
  47. MS-DOS executable is named gs386: look for the line that says
  48.     set PS2PDFGS=gs
  49. and change it to
  50.     set PS2PDFGS=gs386
  51. Note that to run ps2pdf on MS Windows, you need the MS-DOS executable: the
  52. Windows Program Manager's 'run' command doesn't allow you to run .bat files.
  53. Alternatively, you can run the "console mode" Windows executable by changing
  54. the above line to
  55.     set PS2PDFGS=gswin32c
  56.  
  57. Limitations
  58. ===========
  59.  
  60. The most serious limitation of ps2pdf is that text in any font other than
  61. the 14 Adobe base fonts (Courier, Times, and Helvetica families, Symbol, and
  62. Zapf Dingbats) is converted to bitmaps.  ps2pdf also usually converts
  63. strings to bitmaps if the string is in one of the 14 base fonts but it
  64. contains a character that uses a non-standard encoding.
  65.  
  66. ps2pdf currently does not implement any of the image resampling or
  67. compression options of Distiller.  It does implement setdistillerparams, and
  68. recognizes all of the parameters documented in Adobe Technical Note #5151
  69. except for the ImageDict parameters, but the only ones that actually have
  70. any effect are ASCII85EncodePages, CompressPages, CompatibilityLevel, and
  71. UseFlateCompression.  It could implement LZWEncode, but doesn't do so
  72. because of Unisys' threats regarding the Welch patent: instead, it treats
  73. LZWEncode as calling for Flate compression.
  74.  
  75. Known problems
  76. ==============
  77.  
  78. In some cases, PDF files created using ps2pdf work with Adobe Acrobat on
  79. Unix but fail using the Windows version of Acrobat.  One error that has been
  80. observed using versions of Acrobat reader for Windows is: "There was an
  81. error processing a page. A rasterizer error occurred."  This error has been
  82. observed using both Acrobat version 2.1 and the Alpha 2 release of Adobe
  83. Amber.  (Adobe may have fixed this problem by now.)
  84.  
  85. Benefits of using ps2pdf
  86. ========================
  87.  
  88. Despite the limitations of ps2pdf, the class of "suitable" documents is a
  89. large one.  Many users report that the combination of of ps2pdf with Acrobat
  90. is be superior to using a generic PostScript viewer (psview or ghostview),
  91. particularly for documents with many pages where the navigational support in
  92. PDF files reduces the overhead involved in navigating conventional
  93. PostScript documents.
  94.  
  95. For certain documents, ps2pdf is much faster than Adobe Distiller, and may
  96. be suitable for run-time conversions.  [Note from George White: I haven't
  97. seen a head to head comparison, but distiller seems slower when running on
  98. what should be a faster system (e.g., distiller on a PPC Mac vs a 25 mhz
  99. '040 NeXT running ps2pdf), so I think this is fair -- also, one of Mark
  100. Doyle's postings indicated that distiller was not fast enough for use as a
  101. run-time server.  In contrast, I find that I can use ps2pdf as a
  102. post-processor during routine document creation.]
  103.  
  104. Acknowledgements
  105. ================
  106.  
  107. Thanks to George N. White III of the Ocean Sciences Division of the Bedford
  108. Institute of Oceanography in Dartmouth, Nova Scotia <aa056@chebucto.ns.ca>,
  109. for extensive testing of early versions of ps2pdf, and for contributing most
  110. of this writeup.
  111.